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GENERAL 


The purpose of this document is to provide a functional 
description of the 81800/81700 REMOTE JCB ENTRY program» (SDL 
version) as it exists at the Mark VI.0 (or tater) tevet of 
released software. | 


The 81800/81700 REMOTE JOB ENTRY program uses deta communication 
techniques that allow the operator to enter» through the 
81800/81700 computers a job or program to be executed on a 


central coagputer. Both the 81710 and the 61720 series of 


computer may be used as a remote terminai. The centrat computer 
system may be any B6700/7700 or 82700/3700/4700 Burroughs 
cosputer. | 7 


The remote job entry program consists of a single program named 
RJE that is written in the Software Development Language (SDL). 
The RJE program is a datacoma handter that performs ail 
transmitting and receiving of data to and from the central 


computers and sends att messages received from the central 
coaputer systea to the appropriate output device. 


it is assumed that the reader has a working knowledge of the 


basic hardware and software function of the 31800/81700 data 


processing system and the approprtate central computer systen. 


JMEN TATION 

NAME ; NUMBER 
B6700 Remote Job Entry Information Manual 5000300 
B270073700/4709 Remote Job Entry Inforwation Manual 
81800781700 Software Operation Guide 1068731 
81800/81700 Data Comsunications Information Manual 1989992 


a | i-2 
BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP RJE/STERMINAL CSCOL) 
SANTA BARBARA PLANT —P.S. 2212 5231 CE) 


BURROUGHS REMOTE JOB ENTRY SYSTEM ELOW 


ee we waaneawee EODaeanbanane § 


i j 
4681800781700 MCP Ir i 
Secs ers é { 

{CARD 1 1 ee atkkankh t i ema won owoms 
IPUNCHE <«e3rerrr= *£ ® { 1 ! 
+7 sees { te te i i i 
| § te | { i 
Aenea enst | te i ( } 
§$CARD 1 q * * j i i 
PREADERG wee eestor me RIE Cee een wmsece 1 CENTRAL 1} 
ern e west 3 te a { / 1 COMPUTER! 
i * te i wawwrec=>{ SYSTEM 1 
: tel 2 j te * i i 4 
bo LINE | ( tt * i ' i 
: | tPRINTERIE <weereror * 1 j 1 
tonesment i * ® i ' i 
3 fe * § { i 
prema > t te ® 1 i ] 
ICONSOLE! <ee er ennn>* | * t i i 
{PRINTER? q kak kake hake { err woanwanawy 

goon wnns i | { 

po mnemen wees secs amoonst 
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RJE EVUNCTIONAL DESCRIPTION 


The progras RJE controls the 81800/81700 pertpherals. It reads 


cards» accepts messages from the console printer» displays 
messages on the consote printers» prints output and punches cards. 
It is also responsible for data communication with the centrait 
computer syste. The transfer of data from the remote to the 
central coaputer and back occurs as follows: 


The remote user prepares a card deck for transmission to the 
central computer systea. The card deck is read» compressed and 
packed by the 81860/81700 RJE program and transmitted to the 


central computer system. The central computer system will create 


@ pseudo reader file for each job in the card deck being 
transmitted. Execution of each job will cccur when ait the data 
for that job has been received by the centrat computer system and 
the pseudo file built. All output from these jobs will create a 
printer or punch backup file at the central computer site. 


When the job is conpleted> aif associated printer and ounch 
output created at the central computer system is transmitted to 
the 81890/B81700. The 81800/81700 RJE program accepts this output 
and prints and punches it on the local printer or punch. Ait 
console printer sessages displayed by the executing program at 
the central computer system are transmitted directly back to the 
Bis00/BL700 system when they are disptayed. 


The above cycte describes the flow of data between the 
Bi800/B1700 systesz and the central computer system and is 
referred to as a job stream. Any number of job streams may be 
initiated at the same time from the B81800/81700 computer. The 


nuaber of jobs being executed at one time is timited onty by the 


central coaputer systems restrictions. 
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SYSTEM REQUIREMENTS 
Fotlowing are the ieduace requirements: 


&8K Meaory - (This memory includes MCPII and RJE) 


80 or 96 coluan card reader | | 
80 or 96 column card punch Coptionat ) 


120 or 132 print position printer 


Console printer 
Disk Ccartridges pack or head-per-track) 
B1800/81700 single fine controi or mutti tine controt 


81800/81700 standard synchronous» asynchronous or two wire 
direct connect adapter 


Leaseds switched or direct connection with appropriate data 
sets and cabies 


When using 96 cotuan equipment only coluans 1 thru 86 are used. 


it is isperative that the tiseout period be set to 2.5 seconds at 
the 81800761709 and 3 seconds at the central computer syster. 


The BL800/B1700 RJE package requires Mark V.I tevel MCPII Cor 
higher). It requires the following level of central computer 
system software: 


8270073700747 0C MCP V ASR 5.3 or higher - 
86700 MCP Mark 11.5 or higher 


— 
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AUN TIME PARAMETERS 


Upon execution of RJE>» RJE will took for a disk file tabeted 
*"RJESPARAMETERS™ which may contain the run time parameters. RJE 
widt read this file and process the parameters. If an error is 
found in the file the message: 


“PARAMETERS FILE ON OISK NOT VALIO~<fLast portion of file scanned>” 


wid be displayed and the file ignored: requiring manual entry of 
the run tine parameters. If an exception condition was realized 
when trying to read the fite the message: 


“PARITY ERROR ON DISK FILE “RJE/PARAMETERS* - FILE NOT USED” 


will be disptayed and the file ignored» requiring manual entry of 
the run tise paraneters. 


The fite tLabeled “"RJE/PARAMETERS™ on disk can te tgnored at 
execute time by setting switch 9 to any value other tnan zero. 


EXAMPLES EX RJE SW 0 = Ls 


The parameter entry» whether from a card reader» disk file or 
console printer is free form. Parameters must not have imbedced 
blanks and parameters with equat signs must end with a blank. 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 
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If the file "“RJE/PARAMETERS” is not on disk or the fite is itn 

error or if RJE has been instructed to ignore the filer» the 

following sessage will be disolayed» indicating the nanual entry 
of run time parameters to RJE is recuired: 


“DEFAULT PARAMETERS?” 


The operator can now enter run time parameters or use the default 


run time paraaeters. 


The fotloning are acceptable responses to the "DEFAULT 


PARAMETERS?* message: 
<job-nuaber>AX<PARANETER LIST> 


< job-numb er>AXEND 


<job-number>AaxR 


<job-nuaber>AXxYEs 


il 


<PARAMETER LIST> is a list of run 
time parameters. 


Ati run time parameter entries 
from the console printer are 
conplete. This message is onty 
valid after the corsote message: 
"FNTER FURTHER PARAMETERS OR END.” 


Read the run time parameters fron 


a card file "CARDS" tabeled "RJE/ 
PAZAMETERS”. 


Use default parameters. 
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The error message: 
"INVALID PARAMETER DETECTED" 


will be displayed if either of the following occurs: 


Le Parameter tist from console printer or card reacer contained 
an tavatid parageter. 


2e Neither "R*.» "YES*»s "END" nor <PARAMETER LIST> was entered. 
Following the error message» an additional field indicating the 


fast group of characters scanned by RJE is aiso displayed» to 
assist the user in correcting the error. 


If the run time parameter entry is from the console printers» RJE 
will disptay the following message after vatidating the previous 
entries: | | 


"ENTER FURTHER PARAMETERS OR "END" 


If the run tiae paraaeters entry is complete» the operator enters 
“ENO*. Othernise the operator can enter more parameters. 


Notes “R™» “YES* and “END” must immediately foltow the "AX" when 
responding. 
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PARAMETERS DEFAULTS AND FORMATS 


The following is a list of atl default parameters; specific run 
time parameters defautts are overriaden ty entry of that 
parameter in the card file “RJE/PARAMETERS” or by entry of that 
parameter in the paraseter tist entered on the consote printer. 


RUN TIME PARAMETER DEFAULTS — 


PARAMETER MEANING 


<< 2p Oh a ap 1 oh oD |S a a a om a a om 


ADDRESS=PP:CCsAA This parameter descrites the address of the 
| specific data conm line on which RJE ts to 
rune PP3CC3AA are the port» channet and 
adapter address of the tine (PP>» CC and AA 
must be two decimal digits in tength and 
cotons are required). 


Example: = ADDRESS=07:213:300 


Defauit: = ADDRESS=07: 14:00 


AUDIT This parameter instructs the programs to oapen 
and begin writing to the “DC/AUDIT.FILE"» so 
that ali comeunication between RJE and the 
central computer system may bte monitored 
through the us2 of the utility program 
DC/AUDIT. It is also possible to start and 
stop auditing while running. If this 
parameter is entereds the message: 


"AUDIT FILE OPENED AT <time> ON <date>" 
will be displayed when the file is opened. 


Defauit: No auditing | 
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IOLE. ON. LOG. OFF 


LEASED 


NO-PRINTER 


NO.PUNCH 


P.eSe 2212 52351 CE) 


This parameter sets the maximum buffer size 
being transmitted or received. “NNNN® must be 
from 2 to 4 decimal digits in tength and its 
walue must be froa 8&0 to 402 inclusive. It is 
possibte to change this value while running by 
using the *.SIZE=NNNN”* controt message. 


Oefault: BUFFER.SIZE=402 


When running on teased tines and the host 


terminates the sessione RJE will attempt to 


re-establish the link. If this feature is not 
desired» this parameter witt cause RJE to 
place itself in an idie state whenever RJE 


togs off the host or whenever RJE on the host 


systea terminates the link. RJE will then 
resume normal operation whenever it receives a 
message from the host system or a message (for 
transmission is enterad to RJE. 


Default: R JE wiil rerestablish ai tink 
whenever one is broken if a teased-tine is 
used. | 


This instructs RJE that the line over which it 
wilt be running is a teased tine. Should this 
Parameter be entered when RJE is not running 
on a teased line» the sessage: | 


"ERROR: INVALID ADAPTER TYPE” 
“itl be displayed and RJE wittl terminate. 


Defautt: Switched 


If no printer is present at the remote site or 
no printer output is desired» this parameter 
should be entered. Following establishments a 
message wiili be sent to the central computer 
system informing it that no printer is present 
at the reaote system. This parameter may be 
averridden white running via the *.RY LP* 
control message. 


Oefauit: A printer is assumed to be present 


tf no punch is present at the remote system or 
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no punch outout is desired then this parameter 
shoutd be entered. Following the 
establishments a message wiil be sent to the 
centrat computer system informing it that no 
punch is present at the remote systen. This 
parameter may be overridden white running via 
the *.RY CP" control message. 


Default: <A punch is assumed to be present. 


NO.REMOTE The use of this parameter prohibits RJE from 
opening its remote file for SMCS communication 
regardless of the setting of SW9» or how the 
program was executed. . 


Defautt: The remote file wilt only be opened 
af RJE is requested. 


REMOTE With the use of this parameter» RJE wil 
7 atteapt to open its remote file for. 
po communication with SMCS. 


Default: The remote file wittl only be opened 
if RJE is requested. 


SWITCHED | This instructs RJE that the line over which it 
widi be running is a switched tine. Should 
this parameter be entered when RJE ts not 
running on a switched tines the message 


"ERROR: INVALID ADAPTER TYPE" 
witli be displayed and RJE witl terminate. 


Cefauit: Switched 


ID=XXXKXeeccvcces At the central computer» it may be necessary 
to identify the remote computer by sending a 
unique [0 message identifying the remote. 
computer. This ID field may te entered with 
this parameter. If no 1D parameter is entered 
rone will be sent. The 10 messages» if any» 
watt be sent to the central coaputer following 
establishment. The 1D fieid must be from i to. 
i7 characters in tength with no embeaded 
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blanks. 


Defauit: No {D0 message sent. 


USERCODE=XXXeces A remote user may enter his usercode with this 
or this parameter. The Length of the usercode 
USER=XXXewec may not exceed 10 characters or it witt be 
truncated. It may have no imbedded blanks. 
The usercode» if it is entered» will be sent 
to the host automatically following establish- 

ment. 


: | Default: No usercode is sent. 


PASSWORD=XXXs0- A user*s password may be entered with this 
or paraneter. If it tis entered it witl auto- 
; PASS=XXXeee maticatly be sent to the host following 


establishment and transmission of the user's 

usercode to the host. The password entered 

may have no imbedded pbianks and may not 
exceed 10 characters or truncation wiftt occur. 
| If a password is entered without entering a 
usercodes RJE will display the message: 


"USERCODE PARAMETER NOT ENTERED* 


RJE wild then ask that the parameters be 
entered again. 


Defautit: No password is sent. 


END The entry of parameters may be terminated by 
this parameter. If found in a parameter list, 
ail scanning of parameters will cease. Any 


parameters entered following END wiil be 
ignored. Through this parameter the necessity 
of entering an additional SPO message to 
terminate parameter entry is avoided. 
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PARAMETER LIST ENTRY 


If the operator desires to override one or more of the default 
run time parameters» enter “R” or <PARAMETER LIST> in response tc 
"DEFAULT Pan ene senses 


If the entry is through a <PARAMETER LIST> or the console 
printer» the operator can enter up to 72 characters containing 
one or more parameters to override the default paraneters. A 
parameter entry must be contained whol!y in the corsote printer 
response. 


Additionadt entries can be entered after RJE disptays: 


@ENTER FURTHER PARAMETERS OR “END®™ 


If the run tise oarameters are entered through the card reader or 
a disk filter each card or disk record can contair one or nore 
parameters. Each parameter entry must be contained wnhotty in cre 
card or disk record. 


The parameter entry» whether from a card reader or console 
printer is free fora. Parameters must not have embedded btanks 
and parameters with equal signs sust end with a tlank. 
If an error its detected> C(invatid keyword or value)» the 
parameter scan is ended and the fottowing error message is 
displayed. | 

“INVALID PARAMETER DETECTED*® 


The operator must re-submit the entire list of parameters. 


Ptr pape nese BER wit ene Sec oe nee eee 
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RJETSNCS REMOTE FILE INTERFACE 


It ts possible to run RJE under the controt of SMCS. In this 
mode» ait output SPO messages received from the central computer 
and ala relevant output messages generated by RJE witl be sent to 
SMCS» and will be displayed on the tocat SPQ. Any control 
command received by RJE through its remote file will route its 
reply sessages via SMCS to the user initiating the conmand. 


Alt input messages received by RJE through its remote fite wilt 
be treated as if entered from the tocat SPC. Note that alt reply 
messages will be returned through the remote file anc wiil not be 
displayed. | 


RJE must be instructed to open its remote file in order to run 
under the control of SMCS. This may be accomplished 5y using the 
"REMOTE" operating parameter or by executing RJE with the vatue 
for switch 9 other than 0. 


EX RJE SW 9 = 1 


Note that the use of the “"NO.REMOTE"* input parameter witi 
prohibit the opening of the remote file regardiess of the setting 
of switch 9. 


“Aa 
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OPERATING PROCEDURES 


Upon executing RJE» the following message will be dis»vlayed after 
the regular system messages if parameter entry is to »e done from 
either card reader or the console printer: 


"DEFAULT PARAMETERS?" 


Run time parameters are entered at this time. After verifying 
the parameterss RJE will test the data comn lire and if it 


corresponds to the type expected» it will then display the 


message: | 


®enee B1800/81700 RJE <time> <date> s«x** 


RJE wiit then attempt to estab!ish communications with the 
central coaputer syste. For switched tines» it witli be 
necessary to smanuatty dial the central computer system at this 
time. A message is displayed to indicate that the central 
computer has made a connections either: 


"ONLINE™ or "HOST = STABSLISHING™ 
depending upon which systen sees th: other's establishment first. 


Immediately after the run time paraneters have been entered» RJE 
will queue a nusber of control messages for transmission to the 
central computer system as soon as RJE becomes logged on at the 
central coaputer. These messages inctude the current operating 
buffer size of RJE» the status of the B1800/B81700"s printer and 
punch and user*s ID field» if one was entered (See RUN TIME 
PARAMETERS above). If it is desired to not have these messages 
sent then RJE should be executed as fottlows: 


EX RJE SW 1 = 1 


It would be necessary to do this if the tevet of RJE at the 


centrat computer system is not high enough to support the 
reception of these messages. If this is the case then the RJE 
user should hesitate to use the control messages: “"7.RY CP™» "RY 
LP™, @=.S5¥ CP» *.SV¥ LP®» *.CP NR™> “.LP NR™ (See SYSTEM CONTROL 
MESSAGES). 
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The first function of an RJE session after a valid tink has been 
established is the successful cogpletion of a security test. The 
user must enter a “USERCODE* and “PASSWORD” that the central 
conputer systes recognizes. Until such time as this is 
accomplished and a “LOGGED ON" control message sent to the remote 
site» an additional darkened fieid is printed following every 
console . printer message displayed. This field is used for 
entering one*s "USERCODE” and "PASSWORD™ thereby providing remote 
system security. An example of the tog-on procedure is: 


eee B1800/B1700 RJE 09/15/75 1020920782 wane 
ONLINE 

‘BET00 SYSTEN/RJE 2272050 MIX=6415 
Waaaasasagaaaaaaasaaagaaa 

# USERCODE? 

9393939999299939399999900 

# AND YOUR PASSWORD? 

2999999999939299999999a92 

RJE2 LOGGED ON AT 10209231 09/15/75 

SESSION 6417 


The darkened €232332) fieids are used for entering one's 
"USERCODE* and "PASSWORD". Refer to the central computer's RJE 
manuais for each system*s unique tog on requirement. 


Until such time that a "LOGGED ON” control message is received by 
RJE it will not be possible to transmit any card decks to the 
central computer. If this is attempted» fottowing the entry of 
the “.READ™ or *.RE"™ control message to command RJE to process a 
card file (See LOCAL SYSTEM CONTROL MESSAGES)» the message: 


"REQUEST IGNORED: NOT LOGGED ON* 


will be displayed. Adso» until RJE ts togged on» any print or 
punch buffers received by RJE will not be processed but will 
instead be discarded. 


If it is desired to send card buffers to the central computer 
system when RJE is not fogged on» the tocail system contrat 
message *“.RYCR* wilt permit this (See LOCAL SYSTEM CONTROL 
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MESSAGES below). Following the entry of the “.RYCR®™ controal 
message it will be possible to enter card decks through the 
".READ*™ or *.RE*™ control message . RJE wilt also then process 
any print or punch buffers received» if possibie. Buffers witt 
no longer be discarded when received. tastly» following entry of 
the “".RYCR*®™ control message the darkened fieid shown above wiil 
no tonger be dispiayed following every console printer message 
received. | 


REMOTE OECKS 


Ait cards with invalid characters in the first cotusn are 
considered to be controt cards for the 81800/81700 MCP. Since 
decks to be sent to the central computer system aiso nave invalia 
characters in the first cotluan of control cards (See 86700/7790 
or 82700/73700/4700 systems information manual for exact deck 
format )> a specitiat feature has been imptemented in the 
Bi800/B1700 MCPII permitting programs to read controt cards» 
namely the STREAM and TERMINATE super delimiters. Aldi remote 
decks must have the foliowing format: 


PSTREAM RJE/CARDS 
REMOTE DECK CS) 
PTERMINATE RJE/CARDS 


tf there are no parameters entered via the *".RE* or ™.READ" 
cosgmand»s the prograsa will default to a card file with the file 
nage *RJE/CARDS*. | 


Ail card images in the remote deck(s) with invalid characters in 
catluen one will be passed to the central computer after RJE has 
converted the invalid character to a nutt (2002) character. 
MCPIE rejects cards with invalid characters in any cotumn = other 
than one. | 


A@t deckse regardiess of size» must have the detliniters around 
them. If the fast card is not a TERMINATE cards RJE wilt suspend 
transmission of any cards buffers until either additional cards 
are ptaced in the card reader or until a “TERMINATE RJE/SCAROS” 
record is read whereupon the last buffer is transmitted and the 
file ciased. STREAM and TERMINATE super delimiters way aiso be 
used with pseudo readers; there is no difference in the format 
of the remote decks). The BL8CO/B1700 is capable of reading 

oniy ES8CDIC card decks. 
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{f the RJE user desires to equate the card file to tape or disk, 
central coagputer controt cards must be created on tane or disk 
file that will tater be file equated. It is an RJE requirement 
that aii data cards and corntrot cards for a particular job ce 
contiguous. Therefore> it is necessary for the RJE user» when 
creating disk or tape files for transmission by RJE to make sure 
that column one on alt centrat computer control cards contains a 


nuit code €23002). 


The RJE user can create tape or disk files for RJE transmission 
by using the STREAM and TERMINATE super delimiters. If a card 
fite is delimited by STREAM and TERMINATE» the MCP will replace 
the first character of adil control cards with a null code (20002). 
The RJE user must avoid having data cards with invalid characters 
and question aarks (2?) in the first cotuan. 


With the 7.0 and tater releases of RJE the need for the STREA™ 
and TERMINATE super detimiters can be cypassed. If the "2?" 


parameter was supptied in the expanded “*.READ" command and 


instructed RJE to open and begin transmission of a file to the 


centeal coaputer> RJE wild examine each record of the file for 


the existence of a "?" in the first position of the record. tf 
present it will be treated as a controi card and the question 


@ark converted to a null character before transmissicn. 


Since many keyboard devices wilt not permit the entry of a nutt 
character» this facility is primarity for the user communicating 
to RJE via the SMCS remote file» and witt permit source fites 
created with CANDE» for examples to be transmitted to the central 
computer. Adi transmission between RJE and the centrat computer 
is done in the ASCII character format and therefore atl card 
characters read by RJE must be such that they will transtate into 
a vwatid aAaSCII character. If this is not the case or if a 
character is a special data coma control characters then RJE wiit 
transiate any such characters into a question mark before 
transmission. The actual conversion of the EBCDIC characters is 
accoaplished by the 81800/81700 datacomm hardware. 


In order to have a deck read and transmitted to the centrat 
coaputer RJE must be expressiy commanded to transmit the deck or 
file by using the “*.RE"% or “.READ® tocatl RJE system control 
message. If RJE is not Logged on at the central computer system 
then after the *.READ™ or “.RE" ts entereds RJE wilt disptay: 


"REQUEST IGNORED: NOT LOGGED OA" 


a Ai Le es ee ee ee 
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If RJE has received a message from the central computer aborting 
its card reader» then after the "“.READ" or ™.RE” has been 
entered» RJE will display: 


"REQUEST IGNORED: CARD READER ABORTED*® 
If a *.READ™ or *.RE* is entered while the RJE program already 
has an input file open» RJE will display the message: 
“CARD READER ACTIVE WILL TRANSMIT FILE "<FILENAME>”™ WHEN 
READER BECOMES AVAILABLE” 


In the case of the first two conditions» it is posstbhie to 
override these states. If the “".RYCR®@ Cready card reader) tocat 
RJE system controt command is entered the RJE program witt accept 
either ".RE® or *.READ"™. 


in the case of the third condition RJE is already transmitting a 
file to the HOST. RJE will queue the read request and transmit 
the file when the reader becomes available. If the queue is full 
(request limit = 100) RJE will display: 


PREQUEST IGNORED: REQUEST QUEUE FULL”® 
and will ignore the *.RE* or *.READ* command. 
Finally» if an atteapt is made to open a file which does not yet 
exist» RJE wilt display the message: 
"REQUEST IGNORED: FILE "<filename>” NOT PRESENT 
This probtesm can be avoided by making sure the file exists in the 


system before entering the “*.RE*" or *.READ™ command. 


When an input file has been successfully opened and transmission 


beginss RJE wild display: 


“BEGIN TRANSMISSION <device> FILE <filename>* 


Upon successful transmission of the file to the central computer 
RJE wilt disptay: 
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"END TRANSMISSION <filename>*® 


The file wilt then be saved and not purged from the system. 
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CENTRAL COMPUTER SYSTEM CONIROL MESSAGE 


Normaat consote printer input message for transmission to the 
centrat coaputer uses the following form Cup to 72 characters). 


<job-nuaber >AX<a#gessage> 
where <job-nuaber> refers to the job-number of the RJE program. 


The content and format of these console printer messages is 
dependent on the central computer system. In general» these 
messages inctude ait centrai computer input messages which attow 
the remote user to check the status of» and exert control over» 
alf programs and data files entered via the remote terminal. 


B1800/B1700 RJE LOCAL CONTROL COMMANDS 


If a consote printer message is entered with a *." (period) as 
its first character» it is considered to be a locat control 
command intended for the 981800/81700 RJE program. Ali vatid 
B1800/B1700 RJE tocal control commands are explained in 
alphabetical order in the following list. 


2AUDIT 


The audit» .AUDIT» command initiates or terminates the writing of 
data comm 1/0 activity to a disk fite. fhe first entry of -AUDIT 
initiates the audit function and the next entry of »AUDIT 
terminates the audit function. There is no timit to the number 
of times the audit function can be initiated or terminated. A 
utility program named DC/AUDIT is provided to interpret the disk 
fite and produce an audit report. | 7 a 


Exaaple: <job-numberAX-AUDIT 
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2fLCP 


The close card punch» .CLCP» command «ilt close the card punch 
file. 


Example: <job-number>AXx.CLCcP 


The close line printer, eCLLP» command witd ctose the printer 
file. . | 


‘Example: <job-number>AX.CLLP 
—-2fP NR 


The card punch not ready» .CP NR» command informs the 81800/81790 
RJE progras and the central computer system that the card punch 
has become not ready. The central computer system wilt 
teaporarity suspend transmitting buffers for the punch device. 


it is the responsibitity of the 81800/81700 RJE operator to 

tnforma the 81800/81700 RJE program and the central computers» that 
the card punch is ready to receive data. The tocat controt 

command ready card punches .RY CP» has been provided for this 

PUT POSe. If the card punch device has become inoperative then 

the tocat control command save card punchs .SV CP» has been 
provided. | 


Example: < job-number >AX.CP NR 


ried 
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The establishment» ~.£ST» command causes the 81800/81700 RJE 
program to atteapt to re-establish the tine connection with the 
central corputer systen. The message "ONLINE" 1s displayed when 
the Line cannection is re-established. 


The eEST command may be used in conjunction with the retry 
function. The error sessage “REIRIES-UP™ is displayed when the 
current buffer being sent to the central computer system is not 


being received. By entering the EST command the buffer being 


sent wilt be discarded and an attempt wilt de made to 
revestabiish the line connection. | 


Example: <job-number>Ax.E£ST 


2i0 


‘The log off» -LO> command wilt aiiow the operator to enter the 


focal control commands .STOP and .WAIT white stilt logged on to 
the central computer. The -L0 command is a protection feature 
against entering ~.STOP or .WAIT while stilt Logged on» which 
could resuit in loss of buffers being received. 


Exampte: <job~nuaber >Ax.t0 


 -¢h.9 


The loge .L0G» command outputs» on the console printers a summary 


of tine exceptions that fave occurred during transmission. By 
analyzing the <NUMBER> displayed» the operator can obtain an 
indicatien of the quality of the data comm tine connection and 
the rate of error activity on the data comm tine. Each .LOG 


command entered resets the counters to zero after they are 


displayed. The formats of the summary messages are listed below. 


<NUMBER> NAKsS sent because of parity errors. 
<NUMBER> inmplied NAKs sent because no buffers. 
<NUMBER> timeouts tn read operation. 

<NUMBER> other exceptions in read operation. 
<NUMBER> exceptions in write operation. 


“~ 
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Exanpte: <job-number>AXx.LOG 

2iP NR 


The Line printer not ready» eLP NR» command informs the 


81800781700 RJE program and the centrat computer system that the 
line printer has become not ready. The centrat computer system 
witt temporarily suspend transmitting buffers for the printer. 


It ais the responsibility of the 81280C0/81700 RJE operator to 
inform the B1800/81700 RJE programs and the centrat computer» 


that the Cine printer is ready to receive data. The tocat 
controt command ready tine printers «RY LP» has been provided for 
this purpose. If the tine printer has trecome tnoperative then 
the tocat control command save tine printer» .SV LP» has teen 
provided. 


 Exaapte: <job-number >AX.LP NR 


sREAD OR -RE 


The reads .READ of .RE» command causes the 81890/81700 RJE 


program to open a card file tabetfled "RJE/CARDS" and begin 
transmitting the data to the central coaputer system. KHhen the 
end of file condition has been detected the card fite wiit be 
closed. The «READ or ~RE command is required to read each card 
fite. Acard file is any group of cards whose first card is a 


~STREAM card and whese tast card is a TERMINATE card. 


The .READ or .RE command is oniy valid if the 81800/81700 RJE 
program has been property logged on with the central computer. 
It is possibie to override this feature by entering the local 
cog@and .RY CR. 


‘Exampte: <job-number>AX.READ or <job-enumber >AX.PRE 


Parameters can be entered with the “.READ™ or ".RE* controft 
command. Att cf the following parameters are optional and may be 


entered in any orders preceded by the *.READ”™ or “.RE” command 


without tabedded bianks. 


PDURE RED EE ke CLEP uiene GheLete Ghent eerie PEt Toe 
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ZCCONTROL CARD OVERRIDE) 


The *.READ™ of ®.RE" command fotlowed by a question = mark 


instructs RJE that the file to be opened has controt cards with 
question marks as the first record. With the use of this 
parameters each record in the fite which has a question mark as 
its first character witt have the question mark changed to a NULL 
code before transeission. The central system will then recognize | 


the record as a control card. 


TAPE 
DISK Cinput Device Type) 
CARD 


If one of the above is entered>s RJE wiil expect the input fite to 
reside on the device specified. If more than one input device 
type is specified» the tast wilt be used. 


The default input device type is “CARD”. 


 *<file-naze>* (Input File-Nase) 


this parameter specifies the name of the input file. The 


file-name aust be surrounded by quotes (") with no imbedded 


blanks. A file name of up to 32 characters may be specified» 


with the pack-id» multifite-id and fite-id separated by stashes 


—€"*s*). If more than one file-name is entered» the tast wifi be 


used. 


The defautt file-name is "RJE/CARDS”. 


Exampte: ".,REAC DISK “USERPACK/SOURCE/FILE™ ? 


TNE REReTE SEE te 
* 
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2RY CR 


The ready card readers eRY CR> command wilt enable the 
BL800/BL70CG RJE program to read cards again» if the central 
computer has instructed the 81800/81700 RJE program to hatt 
tegporarity or abort its card reader The .READ or .RE local 
command is stiti required before the 81800/81700 RIE progres can 
start reading cards. 


If the 8£800/81700 RJE program has not been property togged on 
with the central computer the .RY CR command witt altow the 
Bi800/B81700 RJE program to read cards and transmit the data file. 
In addition the darkened field that is displayed after every 
console printer message sent from the centrat computer wiil be 
ignored. . 


Example: <job-number>ax.RY CR 
2RY cP 


The ready card punches «RY CP» command informs the 81800/B81700 FJE 
progras and the centrat computer system that the card punch 
device is now ready to receive data. Any data stream that was 
temporarily suspended by using the .CP NR Local control command 
“ili continue without toss of data. If the tlocat controt command 
SV CP was entereds the data file will he transmitted beginning 
from the first record of that fiie. 


The .RY CP command is only vatid if the .CP NR or .SV CP was 
issued previocusty. 


‘The oRY CP command will override the run time parameter NO.PUNCH. 


Example: <job-number>AX.RY CP 


SERRE SET eH a EE eS Se ee dace ee) earietse fact Pelee BF EE 
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2RY uP 


The ready tine printer» .RY LP» command informs the 81800/B81700 
RJE prograg and the central computer system that the line printer 
is now ready to receive data. Any data stream that was 
tenporarity suspended by using the .LP NR Locat controt commanc 


wilt continue without loss of data. If the local controt command 


o5V LP was entereds the data file wilt be transmitted beginning 
from the first record of that file. | 


The .eRY &P command is onty vatid if the .LP NR or «SV LP was 
issued previousty. 


The oRY LP command witli override the run time parameter 
NO-PRINTER. | 
Example: <job-number>AX.RY LP 

22 tZE=NNN 


The sizes .SIZE=NNN»x command atlows the 81800/81709 operator to 
set the maxizgum buffer size being transmitted to» and receivec 
from the centrat computer. Where "NAN" ts a three position 
decimai number from 080 to 402. The -SIZE command witt override 
the run time parameter SQUFFER.SIZE whose default value is set at 


—6402- 


Exaapie: | <job-number>AX.SIZE=NNN 
21 OP OR 2ST 


The stop» .STOP or .ST» command notifies the central computer 
system that the 81800/81700 system is terminating the PJE 
session. The B81800/B1i700 RJE program breaks the data comm tine 
connection and tersinates the 81800/8170C RJE prograr. The .STOP 
er «ST command is onty valid when the 81800/81700 RJE program is 
in the togged off moder either» by receiving the logged off 
control message froa the central computer or ody entering the 
focal command .L0. | 
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Example: <job-number>AX.STOP or <job-number >AX.ST 


S¥ cP 


The save card punches .SV¥ CP» comaand informs the central computer 
that the entire card punch data stream being transmitted is to be 
saved at the central computer site. The .SV CP command wilt 
permanently inhibit any further punch streams from being 
trans@itted from the central computer. To re-establish the punch 
stream enter the tocai control command .RY CR. This wild inforr 
the central coaputer to start sending any punch streams that are 
available for transaission. Ait punch streams witt start from 
the beginning of the file. | | 


Exampte: <job-number>Aax.Sv CP 
23 uP 


The save tine printer» oSV LPs command informs the central 
computer that the entire print stream being transmitted is to be 
saved at the centrat computer site. The .SV CL command will 
permanentty inhibit any further print streams from being 
transaitted froma the central computer. To reestablish the print 
stream enter the tocal control coamand -RY LP. This wild infora 
the centrat conputer to start sending any print streams that are 
availabie for transrission. Ali print streams witt start from 
the beginning of the file. 


Example: <job-number>AX.S¥ LP 
2HAIT QR -T 


The waite WAIT or .WT>s command will informa the central computer 
that the 81800/B81700 RJE program is going to break the data comm 
line connection and the 81800/817090 RJE program is waiting for a 
call from the centrai computer system. The 81800781790 RJE 
progras wiit issue a test-op for data-set-ready. When 
data-set-ready comes true the 81800/81700 RJE program witt 
re-establish coggzunication with the central computer. | 
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The .WAIT or -HT comaand is onty valid when the 81800/8170) RJE 
program is in the logged off sode>» either> by receiving the 
logged off control message from the centrai computer or by 
entering the tocai control coamand .i0. 


The .WAIT of .WT can only tbe used when the data comm line 
connection between the centrat computer and the 81800/81700 
system is switched. 


Example: <job-number>AX.WAIT or <job-number >AXx.wt 
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RJE CONSOLE PRINTER MESSAGES 


RJE say display a nusber of console messages either in response 
to a tecat controt message» in response to a message from the 
cent¢rai computer or when the RJE program senses a condition which 
the operator should be notified. The messages and their 
explanations are listed below. 


AUDIT EILE CLOSED AI <time> ON <date> 


This is a notification that the RJE program has closed its audit 
file and stopped auditing» either in response to an *.AUDIT" 
focal control comaand or because the 81800/81709 RJE program is 
going to end of job. 


Response: = None 
AUDIT EILE QRENED AT <tise> ON <date> 


This isa notification that the RJE program has opened its auait 
file and has comsenced auditing either in response to an ™.AUDIT" 
locat control command or due to the "AUDIT" run-time parameter. 


‘Response: None. 
BEGIN TRANSMISSION <file device> FILE "<file-name>" 


This is displayed whenever RJE begins transmitting a file to the 
central computer. The <file device> witli be either "CARD". 
"DISK™» or "TAPE" (defauit tis “CARD™) and <file-name> wiil be the 
label of the file (default is “RJE/TARDS*"). 


Response: None. 


BECONES AVAILABLE 
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CARO PUNCH EXCEPTION 


This is disptayed when the RJE program has detected an exception 


 cendition on the card punch device. The RJE programs marks the 


device not ready and sends a controt message to the central 
computer informing tt about this situation. Any further 
transmission to the device is stopped. 


Response: Enter one of the following tocal control commands: 
| *.RY CP* or *.S¥ CP*. 


ACTIVE WILL IJRANSMIT FILE <file-name> WHEN READER 


This is disptayed in response to a ‘.RE”™ or “.READ™ input 
message. If a fite was currently being transmitted to the 
centrat csaputer when the *.RE* or ".READ” was entered» RJE will 
save the request in the REQUEST QUEUE and transmit the file uhen 
the reader becomes availabie. 


‘Response: None 


CONTROL MESSAGE INVALID 


This eccurs when an invalid local control message is entered. 


Response: Enter the correct local controt coamand. 


DEFAULT PARAMETERS? 
Enter the run time parameters. 


Response: See RUN TIME PARAMETERS. 
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END IRANSMISSION <file-name> 


This indicates that the RJE program has detected end-of-fiie on 
the input file and it has been closed. A special end of controt 
message will be sent to the central computer at this time. 


Response: None 

ENTER EURIHER PARAMETERS OR END 

ines additionat run tise parameters. 
Response? See RUN TIME PARAMETERS. 


‘CONTROL NOT PRESENT 


the B1800/B1700 RJE progrags first function when running is to 


test the presence of the data comm line. If the test does not 
complete after two seconds the RJE program wilt go to end of jebd. 


‘Response? Check controt and re~execute. Make sure the address 


for the tine to be used is correct. 


“ERROR? INVALID ADAPTER TYPE 


This iaplies that a sync» async or direct connect adapter was not 
found at the given address. If the correct adapter was found but 
the RJE program catis for a switched adapter and the adapter is 
strapped leased or if a leased adapter is catled for but the 
adapter is strapped switched. In any of the three cases the RJE 
program will go to end of job. 


Response: Check control and re-execute the RJE program. Make 


sure the adapter strapping satches the run time 
parameters. | 
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HMENT RETRIES UP 


This sessage is displayed after 25 transmissions of an ENQ when 
trying to establish a connection with the central computer. If 


switched lines are being usede the RJE program wilt disconnect 
the data comm tine. If leased lines are being used» the RJE 
program wii attempt to re-establish the data comm tine. 


Response: If running on switched lines» re-diai the centrat 
| computer. 


2EILE" LOCKED 


White opening the audit files the RJE program found the file tc 
be tocked and therefore unavailable. The file is not opened, 
auditing is not done. 


Response? Re-enter ".,AUDIT™® when the status of the file will 
permit auditing. 
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HOST ESTABLISHING 


The receipt of an ENQ from the central computer wilt cause this 


message to be displayed. It is an indication that the central 


conputer is re-establishing the connection with the 681800/81709 
corputer. The RJE program acknowledges the message and 


continues. 


Response? None 


HOST IERMINATING 


Indicates that the central computer system is terminating the RJE 


session. The RJE program witt disconnect the datacomm tine if 
using a switched line or witl attempt to re-establish the 
datacoma line if running on teased lines. 


Response: Rerdial the central computer if running on a switched 
line. 


INVALID PARANETER DETECIED 


An error was detected while analyzing the run-time parameters. 
The additionat characters printed following this message are the 
last characters scanned by the RJE program before the error was 
encountered. 


Response: Correct and re~enter parameters. 
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LINE PRINTER EXCEPTION 


This indicates that the RJE program has detected an exception 
condition on the Line printer. The RJE program marks the device 


not eady and sends a message to the central computer informing 


it about this condition. Any further transmissions to the device 
are stopped. 7 


Response: Enter the tocal controt command *.RY LP™ or ".5V LP”. 


LOSS OF CLEAR IQ SEND 


This indicates that during the last attempt to transmit by the 
RJE prograa a data set probtem occurred. 


Response: Check data set. 


LOSS OF DAIA SEI READY 


This indicates that during the tast data comm 1/0 sequence the 
data set went down. It switched lines are being used» the RJE 
program wiil disconnect the tine Cif a connection had been 
established). 


Response: if switched tines are being used» rediat the centrat 
computer syster. 


MEMORY PARITY ERROR 


When atteupting to transmit a message to the central computer 
system» a parity error occurred white Seon Ee ora This is an 


irrecoverable error. 


Response: None. 
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BURROUGHS CORPORATION 


ONLINE 


“When atteaopting to establish communication with the central 


coaputers either at the start of an RJE session or after the 
focal command “.EST" was entered» this message will be displayed 
when a vatid acknowledgement to the establishment request is 


received by the RJE program. 


Response: — None. | 
PARAMETER FILE ON DISK NOX VALID 


The disk file RJE/PARAMETERS was in error. Run time parameters 
gust be entered from cards or consote printer. The additional 
characters printed following this message are the last characters 
scanned by RJE before the error was encountered. 


‘Response: Enter correct parameters from cards or console 


printer» or correct disk file and re-execute RJE. 


PARITY ERROR ON CARD PLEASE READ LAST CARO AGAIN 


A parity error occurred while processing an input file. 


Response: Re~subsit the last card read. 
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PARITY ERROR ON DISK FILE “RYE/PARAMEIERS“-FILE NOT USED 


The RJE prograa detected an error while reading the disk file 
containing the run time parameters. The run time parameters will 
have to be entered from cards or the console printer. 


Response: Enter the correct parameters from cards or consote 
printer» or correct the disk file and rerexecute the 
RJE progran. 


LINK ESTABLISHED 


When a *.WT* or *.WAIT"™ control message has been entered» and 
switched tines are being used» the RJE program will wait to 
answer a phone catti from the central computer. 


Response: None. 


P& 


NTER Pm on 


An entire print file has been transmitted to the 81800/81709 RJE 


program from the centrat computer. 


Response: None. 


PUNCH “EQF* 


An entire punch file has been transmitted to the B1800/81700 RJE 
progras frosa the central computer. 


Response: None. 
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REIRIES UP 


This indicates that the current buffer being sent to the centrat 
computer is not being acknowledged» either due to the centrat 
computer NAKing the message or because of tine problems which 
cause exceptions nhenever the message is transmitted. The retry 
fdisit is 25. 


Response? None or enter “".EST" to discard the buffer. 


CARO READER ABORTED 


A *.READ® or *.RE* control command was entered to the RJE progran 
while the card reader was aborted (the message "HOST SYSTEM CARD 
READER ABORTED" having been displayed). [t wiii not be possitte 
to enter cards untit the card reader becomes ready. 


Response: Wait or enter *.RY CR. 
REQUEST EGNORED: FILE <filename> NOT PRESENT 
A ™.RE® of *.READ"™ controi command was entered; RJE was not abte 


to open as the file does not exist. 


Response: Create file and re-enter *.RE™ or *.READ™ 
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REQUEST IGNORED: NOI LOGGED ON 


It is not possibie to enter cards to the RJE program until § a 
“LOGGED-ON" controt command has been received from the centrat 
computer Cor a *.RY CR” message entered). | 


Responses Wait until logged on or enter “.RY CR". 
REQUEST IGNORED: REQUEST QUEYE FULL 


A *.RE® ar “.READ™ control command was entered white the input 
file was active and the request queue was atready futl with 199 
requests. 


Responses Watt until files have been transmitted and re-enter 
a * .RE® or * ,.READ*® 
REQUEST IGNORED: SIILL LOGGED ON 


The RJE progras will not accept the ".STOP™» ".ST", “.WAIT™ or 
".WT" controt coamand while it is togged on at the central 
coaputer. | 


Response: Wait untit’ logged off or enter *.L0". 


SPO QUEVE OVERFLOW: PROGRAM ABORT 


It is possible to enter messages to the RJE program at any time 
froa the console printer. Should there be no rooa for any 


messages entered Ca SPQ buffer atready being present for 


transmission) then the RJE program will queue the message for 
itself on a disk fite queue it maintains for this purpose. 
Should this queue become ful (30 messages) then RJE wilt abort 
itsel f. A message is queued in this file onty if tt ts to be 
transmitted to the centrai computer» most tocat commands do not 
require a message to be sent to the centrai computer. 


Response:. None. 
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RJE ELILES 

CARD FILE 


INTERNAL NAME 


= RJECARDS 
LABEL = RJE/SCARDS (Optional) 
DEVICE = CARD» DISK or TAPE 
OPEN.OPTION = INPUT 
BLOCKING = USE. INPUT.BLOCK ING 
PRINT FILE 
INTERNAL NAME = RJEPRINT 
LABEL = RJE/PRINT 
DEVICE = PRINTER OR BACKUP DISK 
OPEN.OPTION = OUTPUT 
RECORDS = 132/1 
PUNCH FILE 
INTERNAL NAME = RJEPUNCH 
LABEL = REJ/PUNCH 
DEVICE = PUNCH OR BACKUP DISK 
OPEN.OPTION = OUTPUT | 
RECORDS = 80/1 
AUDIT FILE 
INTERNAL NAME = AUDIT 
LABEL = DC/AUDIT.FILE 
DEVICE = DISK» RANDOM 
RECORDS = 180/1 
AREAS = 10/100 
‘OPEN.OPTION = INPUT» OUTPUT 
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INTERNAL NAME = SPO-.QUEUE 

LABEL = RJE/SSPO.QUEUE 

DEVICE = DISK» RANDOM 

RECORDS = 81/1 

AREAS = 1/30 

OPEN.OPTION = INPUT» OUTPUT» NEWs LOCK.OUT 


PARAMETER FILE 


INTERNAL NAME 


= CARDS 
LABEL = RJE/PARAMETERS 
«DEVICE = CARDS OR DISK 
BLOCKING = USE.INPUT.BLOCK ING 
OPEN-OPTION = INPUT 


¢ INTERNAL READ REQUEST QUEUE 


INTERNAL NAME REQUEST .QUEUE 


LABEL = RJE/REQUEST 
DEVICE = DISK RANDOM 


SMCS REMOTE FILE 


INTERNAL NAME = REMOTE 
LABEL | , = SMCSFILE 
DEVICE = 
RECORDS = 1737/1 

z §¢ 


NUMBER OF STATIONS 


REMOTE €25) WITH HEADERS 
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eLP NR 2°10 

READ OR .RE = 2=10 
RY CP 3 2-22 

eRY CR 2-12 

oRY LP 9 -2=13 
eSIZE=NNN = 2-13 
eSTOP OR «ST 92-13 


«S¥ CP 214 

(eSV LP | 214 

eWAIT OR WT 9 2-16 

AUDIT FILE CLOSED AT <time> ON <date> 3-1 
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